home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1997 September / Macworld (1997-09).dmg / Shareware World / Comms & Internet / MondoMail / Mondo Mail Read Me next >
Text File  |  1997-06-26  |  9KB  |  114 lines

  1.  
  2.                                                 MondoMail from Acme Technologies
  3.                                                                                     (version 1.1.4)
  4.  
  5. MondoMail is a simple scriptable (thru Apple events) mail gateway program which enables you to send Email from any application capable of sending Apple events. We've provided demos of sending mail from AppleScript applications, FileMaker Pro 3, and EveryWare's Tango CGI. For further information about using MondoMail from these applications, please refer to those demos.
  6.  
  7. MondoMail is copyright 1996-1997 Acme Technologies, and is provided free of charge as a public service. You may not charge money for copies of MondoMail and must keep this package intact if you wish to redistribute it. MondoMail and all associated demos may not be placed on any CD-ROM for distribution without explicity written permission from Acme Technologies.
  8.  
  9. As a free product, we cannot guarantee the same level of support as we do for our shareware and commercial products, but feel free to send bug reports and suggestions at any time. For information on licensing MondoMail for resale or inclusion with other products, please contact us directly.
  10.  
  11. We also offer a "Pro" version of MondoMail as ShareWare, which has additional features not found in this version. MondoMail Pro will MIME-encode message headers and bodies, allows you to specify custom Email headers, has more flexible addressing options, and allows you to set a message's priority. You can download a trial copy from our Web site.
  12.  
  13. MondoMail is very simple to use, and we've provided demos for some applications where people commonly want to have Email sending capability. Please refer to those for more information. Below you'll find details on the Send Mail Apple event MondoMail supports. These are the codes for building up the Apple event from programs such as Tango. NB: MondoMail is not a WebSTAR CGI !!   If you want to use it to send mail from a form submission, you'll have to write your own CGI to process the submission, then send the Email through a direct Apple event to MondoMail.
  14.  
  15.  
  16. Brief Introduction
  17.  
  18. As of Version 1.0.1, MondoMail became fully threaded. After receiving the 'send mail' Apple event and verifying the presence of all required parameters, MondoMail queues the message for sending and returns the string "The mail message has been queued for sending." to the Apple event sender. The mail message will then be sent out asynchronously. MondoMail is a "FAT" application (runs native under both PPC and 68k), but 68k testing was minimal.
  19.  
  20. MondoMail will accept multiple recipients for a message. Each recipient must be separated by a comma, and for best results, there should be no intervening  space characters. For example: "wkw@acmetech.com,support@acmetech.com".
  21. If the comma is followed by one or more spaces, the mail should still send properly, though in earlier versions of MondoMail it would not have.
  22.  
  23. When a message cannot be sent for any reason, it is written out to a "Failed.mail" file in the same directory as MondoMail, along with whatever error information is available. The error number will either be a Macintosh system error, or one of the following:
  24.  
  25.     100        Unable to open networking driver
  26.     101        Unable to create the stream (often a problem in the SMTP gateway address specified)
  27.     102        The connection was lost.
  28.     103        Error resolving a domain name.
  29.     301        Shutting Down. MondoMail had already started preparing to quit and couldn't back out.
  30.     302        Timeout Error.  The server could not be reached before the timeout value was exceeded (120 seconds).
  31.     303        Too Busy Error. There were already too many threads running.
  32.  
  33. MondoMail is configured to quit after 10 minutes of inactivity. 
  34.  
  35.  
  36. Mondo Mail Apple event info
  37.  
  38. Send Mail event
  39. Suite:    '@CME'
  40. Class:    'SnMl'
  41.  
  42. Direct Param:    '----'    Body of message
  43. To                'to  '    email address(es) of recipients
  44. [CC                'cc  '  addresses of CC: recipients]
  45. [BCC            'bcc ' addresses of people to receive blind carbon copy]
  46. from            'from'    email address of sender
  47. subject            'Sbjc'    subject for message
  48. SMTP gateway    'gtwy'    host name of SMTP gateway
  49.  
  50. Returns: a system error or "The mail message has been queued for sending." if the mail was successfully queued.
  51.  
  52. All fields are required for sending a message except the CC and BCC fields. If you're using MondoMail for ListServe type functions, you'll probably want to list all the recipients in the Bcc: field so the people on the list don't see who else is getting it, or at the very least, do not have a super-long list of addresses in the To: field. 
  53.  
  54.  
  55.  
  56.  
  57. Version History
  58.  
  59. 1.1.4    6/26/97
  60. Added support for Chuck Shotton's SiteWatcher Web site monitor application. You can now have MondoMail send Email whenever SiteWatcher notices that a server is not responding.
  61. 1.1.3    3/8/97
  62. Finally got around to adding a proper Date: field to the mail message headers. This is the first release which has a real icon. If it doesn't show up, try rebuilding your desktop.
  63.  
  64. 1.1.2    1/7/97
  65. Fixed a bug related to empty handles. Fixed a problem introduced in 1.1.1 where the absence of a To: field in the message header seemed to through off AIMS, and Bcc: recipients would be put into a To: field automatically. Because a To: field is required in the header, now when none is specified, the string ("Suppressed") is used instead.
  66.  
  67. 1.1.1    1/5/97
  68. Better error reporting for failed messages. To: field no longer required provided at least one of the Bcc: or Cc: parameters is provided. If none given, an error (9000,"No recipients specified") is returned immediately. Fixed a bug introduced when Bcc: and Cc: support was added. Adjusted the amount of time given to other applications while sending messages. MondoMail was being very selfish before, it's now friendlier.
  69.  
  70. 1.1            12/9/96
  71. Added support for CC: and Bcc: fields. Both fields should support multiple recipients separated by commas.
  72.  
  73. 1.0.3     12/3/96
  74. Fixed the AIMS complaint about CRLF end of lines.
  75.  
  76. 1.0.2        12/2/96
  77. Fixed more potential memory problems. Multiple recipient lists may now contain spaces after the separating commas.
  78.  
  79. 1.0.1
  80. Enabled threading support.  Fixed potential memory problems related to unlocked handles.
  81.  
  82. 1.0        First public release.
  83.  
  84.  
  85.  
  86. MondoMail is based on the MailTools CGI sources from John Norstad of Northwestern University. Many thanks for all the excellent resources Mr. Norstad and Northwestern University make available to the on-line community.
  87.  
  88. ACME TECHNOLOGIES PROVIDES MONDOMAIL AS IS, WITHOUT ANY WARRANTY OR PROMISE OF TECHNICAL SUPPORT.  ACME TECHNOLOGIES DISCLAIMS ANY LIABILITY OF ANY KIND FOR ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF MONDOMAIL, INCLUDING, WITHOUT LIMITATION, INCIDENTAL, CONSEQUENTIAL, INDIRECT OR SPECIAL DAMAGES OF ANY KIND, EVEN IF ACME TECHNOLOGIES IS AWARE OF THE POSSIBILITY OF SUCH DAMAGES.  ACME TECHNOLOGIES MAKES NO WARRANTIES, EXPRESS OR IMPLIED, WITH RESPECT TO THE PROGRAM, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. USE AT YOUR OWN RISK.
  89.  
  90. Acme Technologies is a publisher of cool tools for AppleScript and Macintosh Internet Servers. Other software from Acme Technologies includes the award winning Acme Script Widgets, powerful AppleScript extensions for text and list manipulation ; WebDetour, a RAIC-building tool and site management tool for Macintosh Web servers; and FingerToys, a Macintosh Finger daemon which offers endless customization options through finger Gateway scripts. We also offer a number of free utilities from our Web site including MessageWindow, a scriptable application for viewing text strings, ColorFinder, a cool little utility for choosing colors for your Web pages by using an eyedropper to snatch the color from your desktop, and MIND, a Macintosh Name Daemon (DNS server). Acme Technologies is available for custom Web development projects, call or write us for information.
  91.  
  92. You can contact Acme Technologies at:
  93.  
  94. 55 Danbury Road, Suite 2
  95. Ridgefield, CT 06877
  96. USA
  97. +1 (203) 431-1601
  98. http://www.acmetech.com/
  99. sales@acmetech.com
  100.  
  101. Other Product from Acme Technologies
  102.  
  103. WebDetour 
  104.     WebDetour is a flexible and powerful redirection manager for Macintosh Web servers. You can set up Detours to route requests for any document or folder to any other location, on the same or a different server. WebDetour also provides support for configuring multiple computers into RAICs by round-robin routing of requests to each server.
  105.  
  106. Acme Script Widgets
  107.     Provides powerful extensions to the AppleScript language which makes text and list processing hundreds of times faster. Also included are commands for CGI authors which automatically parse form data.
  108.  
  109. FingerToys
  110.     FingerToys is an extendable Finger server for the Macintosh. Also supports making outgoing net connections to any port on any TCP/IP host via an Apple events API, and can be used as a Web->Finger gateway. FingerToys uses CGI-like applications (Finger Gateways) written AppleScript, Frontier, C/C++ to handle each finger request, which means you can provide access to databases, local resources and other services via the finger protocol.
  111.  
  112. PowerGate
  113.     Reboot hung servers from anywhere on the Internet. No matter how badly your server crashes, you can always restart it through the combination of PowerGate and the PowerKey Pro product from Sophisticated Circuits.
  114.